…source-commands (#892)

* docs: add command arguments, validation, and visibility to custom-resource-commands

Documents new features from microsoft/aspire#16710:
- Command arguments (InteractionInput, InputType, InteractionInputCollection)
- Typed argument accessors (GetString, GetBoolean, GetInt32, GetDouble in C#; toArray, value, requiredValue in TypeScript)
- Positional CLI argument passing
- Argument validation (ValidateArguments callback, field-level errors)
- Command visibility (ResourceCommandVisibility.Dashboard, Api, All)

Covers both C# and TypeScript AppHost usage.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: fix ResourceCommandVisibility names and accessor return types

Verified against microsoft/aspire source:

- ResourceCommandVisibility values are None, UI, Api (bit-combinable);
  the previously documented names Dashboard and All do not exist.
  Use UI | Api for "both" (the default).
- InteractionInputCollection.GetInt32/GetBoolean/GetDouble return
  non-nullable values and throw on absent or unparseable input;
  only GetString returns string?. Updated comments and prose.
- Replaced "GetInt32(...) ?? 1" in the example, which would not compile
  against a non-nullable int return, with int.TryParse against GetString.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: clarify custom command input property types

Update the InteractionInput property table to reflect that Label is optional and that Choice options use the IReadOnlyList/InteractionInputOption shape from the product APIs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>

Rename `withRoleAssignments` to `withFoundryRoleAssignments` in the
TypeScript AppHost example following microsoft/aspire#16886 which uses
integration-specific export names to avoid ATS SDK dump collisions.

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

The aspire exec command was removed in microsoft/aspire#16913.
Remove the associated execCommandEnabled feature flag entry from
the CLI configuration settings reference table.

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…ss displayImmediately overload (#897)

Update the 'Auto-open the result dialog in the dashboard' C# example
to use the new four-argument CommandResults.Success overload added in
microsoft/aspire#16906, replacing the lower-level CommandResultData
object-initializer pattern with the more ergonomic factory call.

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…902)

* docs: document --yes required with --non-interactive for aspire update

The aspire update command now validates that --yes is provided when
--non-interactive is specified, matching the existing behavior of
aspire destroy. Add a Non-interactive usage section to the update
command docs to make this requirement explicit.

Documents changes from microsoft/aspire#16829

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

…ion (#904)

* docs: document resource-scoped command help and --include-hidden option

Documents changes from microsoft/aspire#16921:
- Add section explaining that 'aspire resource <resource> --help' shows
  available resource commands discovered from the running AppHost.
- Document the '--include-hidden' option for showing and executing
  hidden resource commands.
- Document the '--' delimiter for passing --help to resource commands.
- Add AppHost selection section with clearer structure.
- Add examples for listing available commands and using --include-hidden.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: use apphost source files in resource examples

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>

…option (#888)

* docs: document AI Agents dialog and DisableAgentHelp config option

Documents the new AI Agents button added to the Aspire dashboard header
in microsoft/aspire#16869, including:
- New section in ai-coding-agents.mdx describing the header button and
  adaptive dialog content
- New Dashboard:UI:DisableAgentHelp config entry in configuration.mdx

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Apply suggestion from @JamesNK

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: James Newton-King <james@newtonking.com>

…mand-specific help (#898)

* docs: update aspire resource command with named options and command-specific help

Documents the new named option support for resource command inputs:
- Named options (--option-name) instead of positional values
- Command-specific --help output showing input types, defaults, and allowed values
- Using -- separator to avoid option name collisions

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address aspire resource review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>

…signments guide (#896)

* docs: document AzureRoleAssignmentResource for programmatic role assignment inspection

Add a new section to the Azure role assignments guide documenting the
AzureRoleAssignmentResource type introduced in microsoft/aspire#16888.

The new section explains:
- The three properties exposed by AzureRoleAssignmentResource (TargetAzureResource,
  OwnerResource, and IdentityResource)
- How to enumerate role assignment resources from a pipeline step
- The null semantics for global vs. targeted role assignments

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* PR feedback

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Eric Erhardt <eric.erhardt@microsoft.com>

* docs: add AspireUseCliBundle opt-in documentation

Document the new AspireUseCliBundle MSBuild property introduced in
microsoft/aspire#16811 that allows AppHost projects to source DCP and
the Aspire Dashboard from the Aspire CLI bundle instead of platform-
specific NuGet packages.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: move CLI bundle opt-in to Aspire SDK page

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: fix Aspire CLI bundle docs rendering

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Revert "[docs] Add AzureRoleAssignmentResource documentation to Azure role assignments guide (#896)"

This reverts commit deed841.

* docs: clarify CLI bundle dependency wording

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: restore role assignments base content

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>

* Initial plan

* feat: add skeleton What's New for Aspire 13.4

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/9761e602-b5d7-47fe-a1e1-4639f2afd3d1

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

---------

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* docs: add WithProcessCommand / process-backed resource commands

Documents the new experimental WithProcessCommand API introduced in
microsoft/aspire#16923, which lets AppHost authors add custom commands
backed by external processes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address review feedback - add ASPIREPROCESSCOMMAND001 diagnostic article, update TS example, conceptualize config sections, vertical array formatting

Agent-Logs-Url: https://github.com/microsoft/aspire.dev/sessions/91ac4d2c-f747-49d2-ade1-2220fd9c5d7b

Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>

* docs: refine process command documentation

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: use node in TypeScript process command sample

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: IEvangelist <7679720+IEvangelist@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>

…cessCommandFactory) (#923)

* Add docs for withProcessCommand and withProcessCommandFactory polyglot APIs

Documents the TypeScript (polyglot) process-backed resource command APIs
introduced in microsoft/aspire#16972:
- withProcessCommand: static process spec registered at AppHost startup
- withProcessCommandFactory: dynamic spec built from ExecuteCommandContext
  arguments at invocation time

Adds fundamentals/process-commands.mdx and registers it in the sidebar
between Custom HTTP commands and Custom resource URLs.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Consolidate process command docs

Move the TypeScript process command factory example into the existing custom resource commands page and remove the duplicate standalone page/navigation entry.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Fowler <davidfowl@gmail.com>

* Add first-class Go hosting docs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Clarify Go publish artifact wording

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Restructure Go integration docs

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Allow known Foundry twoslash gap

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Exclude deprecated Go toolkit package

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Update the generated Bicep snippet in the Azure Front Door integration
docs to reflect the new resource naming introduced in .NET Aspire 13.4
(via Azure.Provisioning.Cdn 1.0.0-beta.2). The profile name length limit
increased from 90 to 260, and child resource names now use PascalCase
Bicep identifier suffixes (e.g., myapiEndpoint) instead of the previous
hyphen-separated lowercase names (e.g., my-api).

Also adds an upgrade caution note warning users upgrading from 13.3.0-preview
that the name change can produce duplicate Azure resources, and explains the
mitigation (delete existing resources or set names explicitly via ConfigureInfrastructure).

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…973)

* Document AddAzureKubernetesEnvironment ingress + AddCertManager flow

Aspire 13.4 ships first-class AKS ingress on top of AddAzureKubernetesEnvironment:
AddLoadBalancer provisions an AGC frontend, AddGateway().WithLoadBalancer()
attaches Aspire gateways to it, and AddCertManager() + AddIssuer().
WithLetsEncryptProduction().WithHttp01Solver() + WithTls(issuer) deliver
automatic HTTPS in a single 'aspire deploy'. Until now docs only covered the
bring-your-own-cluster scenario via the kubernetes-{gateway,ingress}-aks pages.

This change extends deployment/kubernetes/aks.mdx with one continuous
walkthrough that takes the reader from a freshly provisioned AKS cluster to
HTTPS on a custom domain:

- 'Expose your app to the internet' covers AGC subscription prereqs, VNet/
  subnet layout (avoiding the 10.0.0.0/16 service CIDR clash), AddLoadBalancer,
  AddGateway + WithLoadBalancer + WithRoute, the first HTTP-only deploy on the
  auto-assigned *.alb.azure.com FQDN, AddCertManager + AddIssuer +
  WithLetsEncryptProduction + WithHttp01Solver, the typed WithTls(issuer)
  overload, and the bootstrap-secret + FQDN-swap mechanic.
- 'Use a custom domain' adds WithHostname (string + parameter), the CNAME
  setup, and re-deploy/verify steps.
- New troubleshooting entries for stuck certificates, missing gateway FQDNs,
  and the cert-manager SSA force-conflicts behaviour AddCertManager handles.

Existing BYO walkthroughs keep their content and gain a top-of-page tip
pointing AddAzureKubernetesEnvironment users at the integrated path. The
Ingress/Gateway API overview gets a similar pointer. The 13.4 what's-new
page calls the new APIs out under the existing 'This release introduces' list.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Add troubleshooting items for cert-manager AGC scenarios

Surfaced during live AKS deployment validation:
- Let's Encrypt rejects forbidden / non-public-suffix contact email TLDs
- HTTPS listener InvalidCertificateRef recovery (bootstrap secret restore)
- Plain HTTP returns 404 once WithTls is applied (expected behavior)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Mitch Denny <midenn@orangecake.localdomain>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Mitch Denny <midenn@orangecake.local>

* docs: document async chaining support in TypeScript AppHosts

Documents the async chaining feature introduced in microsoft/aspire#17400.
TypeScript AppHosts can now chain through generated async methods that
return wrapper types with a single await, using the new PromiseLike
thenable wrapper pattern emitted by the code generator.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

#1075)

* docs: document legacy apphost.ts compatibility for TypeScript AppHosts

The 13.4 CLI transparently supports TypeScript AppHosts scaffolded by
earlier CLI versions (apphost.ts importing from ./.modules/aspire.js):
it routes generated SDK files to ./.modules/ and rewrites .mts/.mjs
files to .ts/.js (extensions plus inter-module import specifiers) so
existing imports resolve. aspire add/restore/run/start all keep working
without user intervention.

Document this behavior on the TypeScript AppHost page with a new
'Legacy apphost.ts projects (pre-13.4)' section and an opt-in
'Migrating to the new apphost.mts layout' subsection (rename file,
update SDK import, update appHost.path, update tsconfig.apphost.json
includes, delete ./.modules/ and re-restore).

Also add a brief cross-reference in the 13.4 release notes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Update src/frontend/src/content/docs/app-host/typescript-apphost.mdx

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: David Pine <david.pine@microsoft.com>

… Docker integration pages (#997)

* docs: add polyglot WithComputeEnvironment examples to Kubernetes and Docker integration pages

WithComputeEnvironment is now available in polyglot (TypeScript, Python, Java, Go) app hosts
as of microsoft/aspire#17093. Expand the existing tip asides on the Kubernetes and Docker
integration pages to include C# and TypeScript code examples showing how to call the API.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address compute environment review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Sebastien Ros <sebastienros@gmail.com>

…eedback

Co-authored-by: danegsta <50252651+danegsta@users.noreply.github.com>

…998)

* docs: add TypeScript subscribeBeforePublish/subscribeAfterPublish to eventing page

Documents the new publish lifecycle event APIs for polyglot AppHosts
added in microsoft/aspire#17129. TypeScript AppHosts can now subscribe
to BeforePublishEvent and AfterPublishEvent using subscribeBeforePublish
and subscribeAfterPublish builder methods.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: address eventing review feedback

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs: avoid stale eventing twoslash data

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Sebastien Ros <sebastienros@gmail.com>

…st AppHost projects

Documents the Aspire CLI version preflight check for guest AppHost project updates.

Documents DTO collection properties as value-shaped inputs in generated guest SDKs, matching microsoft/aspire#17098.

…st-17348-e33c146007a29244

[docs] Add HTTPS dev certificate guidance to TypeScript AppHost docs

…2-296cf40858d33323

[docs] Update ASPIRE_DCP_USE_DEVELOPER_CERTIFICATE docs for cross-platform default

Update ATS documentation for XML docs-based polyglot API docs, add ASPIREEXPORT015/016 diagnostics documentation, and fix related navigation/link issues.

* Docs: rename ingress WithRoute to WithPath

Aspire.Hosting.Kubernetes renamed the Ingress routing extension from
WithRoute to WithPath. Gateway API kept WithRoute. Update the only
live code samples that still showed ingress.WithRoute (the 13.3
what's-new ingress sample in English and Japanese) and add a short
breaking-change note to the 13.4 what's-new page.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Docs: add WithPath example to Ingress overview

Add a 'Routing paths to services' section to the Ingress/Gateway
overview showing path-based routing with the new WithPath API,
including a brief note about the WithRoute -> WithPath rename and
that the Gateway API equivalent keeps the original name.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Docs: add callout recommending Gateway API over Ingress

Add a tip callout near the top of kubernetes-ingress.mdx linking to
the upstream Kubernetes Gateway API page and the Gateway API concepts
overview, encouraging readers to prefer AddGateway(...) over
AddIngress(...) for new deployments.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* Fix Kubernetes ingress docs samples

Keep the 13.3 what's-new sample historically accurate and declare the Kubernetes environment in the new Ingress routing examples.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Mitch Denny <midenn@orangecake.local>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Sebastien Ros <sebastienros@gmail.com>

…ports (#1079)

Fixes TypeScript AppHost deadlock behavior documented in microsoft/aspire#17508.

The RunSyncOnBackgroundThread option now correctly applies to the
synchronous invocation path of async-returning exports (Task/ValueTask),
not just synchronous exports. Update the ATS-compatible type table and
the ASPIREEXPORT010 diagnostic page to reflect this expanded coverage.

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

…docs

#1082)

Document the new native VS Code Go debugging support added in
microsoft/aspire#17406:

- The Aspire VS Code extension detects the golang.go extension and
  launches the Go debugger via dlv-dap automatically.
- Build flags (buildTags, ldFlags, gcFlags) configured on the resource
  are forwarded to Delve as build flags.
- WithDelveServer and VS Code debugging are mutually exclusive.
- Reorganize the debugging section with VS Code and headless Delve
  as separate sub-sections.

Co-authored-by: aspire-repo-bot[bot] <268009190+aspire-repo-bot[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

… init

Document the best-effort skills bundle acquisition order (cache →
GitHub release asset → embedded snapshot) introduced in
microsoft/aspire#17537. The command now warns and skips bundle-backed
skills instead of failing when all acquisition sources are unavailable.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>